BulkName

Object and Type

Object  : FCGeneric

Type     : Property

Prototype

Public BulkName As String

Description

This property allows you to specify the bulk object for this generic. It also allows you to see the name of the bulk associated with this generic.

When you set the bulk name for a generic, FCFL will associate the generic to the proper bulk object for you. If the FCBulk object does not yet exist, it will create it for you automatically.

When generic objects are created, they are associated with a special bulk, whose name is the empty string ("").

Example

The following example creates two generic objects. They are both placed into the same bulk so that they can be queried and written together in a single unit of work.

JavaScript:

The code in this example is written in JavaScript for inclusion in ASP pages.

  // Create the first object

  var boObj1 = FCSession.CreateGeneric();

  boObj1.SimpleQuery("part_num");

  boObj1.BulkName = "my_bulk";

  // Create the other object. Put it in the same bulk as the first

  var boObj2 = FCSession.CreateGeneric();

  boObj2.SimpleQuery("part_num");

  boObj2.BulkName = "my_bulk";

  // Show that the bulks are now the same

  Response.Write ("Bulk 1 name is: " + boObj1.Bulk.Name); 

  Response.Write ("Bulk 2 name is: " + boObj2.Bulk.Name);

Visual Basic:

The code in this example is written in Visual Basic.

  Dim boObj1 As FCGeneric

  Dim boObj2 As FCGeneric

  Set boObj1 = fc_session.CreateGeneric

  boObj1.SimpleQuery "part_num"

  boObj1.BulkName = "my_bulk"

  Set boObj2 = fc_session.CreateGeneric

  boObj2.SimpleQuery "part_num"

  boObj2.BulkName = "my_bulk"

  MsgBox "Bulk 1 name is: " & boObj1.Bulk.Name

  MsgBox "Bulk 2 name is: " & boObj2.Bulk.Name